home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_include / ASM-I386 / USER.H < prev    next >
C/C++ Source or Header  |  1999-09-17  |  4KB  |  95 lines
  1. #ifndef _I386_USER_H
  2. #define _I386_USER_H
  3.  
  4. #include <asm/page.h>
  5. #include <linux/ptrace.h>
  6. /* Core file format: The core file is written in such a way that gdb
  7.    can understand it and provide useful information to the user (under
  8.    linux we use the 'trad-core' bfd).  There are quite a number of
  9.    obstacles to being able to view the contents of the floating point
  10.    registers, and until these are solved you will not be able to view the
  11.    contents of them.  Actually, you can read in the core file and look at
  12.    the contents of the user struct to find out what the floating point
  13.    registers contain.
  14.    The actual file contents are as follows:
  15.    UPAGE: 1 page consisting of a user struct that tells gdb what is present
  16.    in the file.  Directly after this is a copy of the task_struct, which
  17.    is currently not used by gdb, but it may come in useful at some point.
  18.    All of the registers are stored as part of the upage.  The upage should
  19.    always be only one page.
  20.    DATA: The data area is stored.  We use current->end_text to
  21.    current->brk to pick up all of the user variables, plus any memory
  22.    that may have been malloced.  No attempt is made to determine if a page
  23.    is demand-zero or if a page is totally unused, we just cover the entire
  24.    range.  All of the addresses are rounded in such a way that an integral
  25.    number of pages is written.
  26.    STACK: We need the stack information in order to get a meaningful
  27.    backtrace.  We need to write the data from (esp) to
  28.    current->start_stack, so we round each of these off in order to be able
  29.    to write an integer number of pages.
  30.    The minimum core file size is 3 pages, or 12288 bytes.
  31. */
  32.  
  33. struct user_i387_struct {
  34.     long    cwd;
  35.     long    swd;
  36.     long    twd;
  37.     long    fip;
  38.     long    fcs;
  39.     long    foo;
  40.     long    fos;
  41.     long    st_space[20];    /* 8*10 bytes for each FP-reg = 80 bytes */
  42. };
  43.  
  44. /*
  45.  * This is the old layout of "struct pt_regs", and
  46.  * is still the layout used by user mode (the new
  47.  * pt_regs doesn't have all registers as the kernel
  48.  * doesn't use the extra segment registers)
  49.  */
  50. struct user_regs_struct {
  51.     long ebx, ecx, edx, esi, edi, ebp, eax;
  52.     unsigned short ds, __ds, es, __es;
  53.     unsigned short fs, __fs, gs, __gs;
  54.     long orig_eax, eip;
  55.     unsigned short cs, __cs;
  56.     long eflags, esp;
  57.     unsigned short ss, __ss;
  58. };
  59.  
  60. /* When the kernel dumps core, it starts by dumping the user struct -
  61.    this will be used by gdb to figure out where the data and stack segments
  62.    are within the file, and what virtual addresses to use. */
  63. struct user{
  64. /* We start with the registers, to mimic the way that "memory" is returned
  65.    from the ptrace(3,...) function.  */
  66.   struct user_regs_struct regs;        /* Where the registers are actually stored */
  67. /* ptrace does not yet supply these.  Someday.... */
  68.   int u_fpvalid;        /* True if math co-processor being used. */
  69.                                 /* for this mess. Not yet used. */
  70.   struct user_i387_struct i387;    /* Math Co-processor registers. */
  71. /* The rest of this junk is to help gdb figure out what goes where */
  72.   unsigned long int u_tsize;    /* Text segment size (pages). */
  73.   unsigned long int u_dsize;    /* Data segment size (pages). */
  74.   unsigned long int u_ssize;    /* Stack segment size (pages). */
  75.   unsigned long start_code;     /* Starting virtual address of text. */
  76.   unsigned long start_stack;    /* Starting virtual address of stack area.
  77.                    This is actually the bottom of the stack,
  78.                    the top of the stack is always found in the
  79.                    esp register.  */
  80.   long int signal;             /* Signal that caused the core dump. */
  81.   int reserved;            /* No longer used */
  82.   struct user_pt_regs * u_ar0;    /* Used by gdb to help find the values for */
  83.                 /* the registers. */
  84.   struct user_i387_struct* u_fpstate;    /* Math Co-processor pointer. */
  85.   unsigned long magic;        /* To uniquely identify a core file */
  86.   char u_comm[32];        /* User command that was responsible */
  87.   int u_debugreg[8];
  88. };
  89. #define NBPG PAGE_SIZE
  90. #define UPAGES 1
  91. #define HOST_TEXT_START_ADDR (u.start_code)
  92. #define HOST_STACK_END_ADDR (u.start_stack + u.u_ssize * NBPG)
  93.  
  94. #endif /* _I386_USER_H */
  95.